<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>

  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">

  <meta name="Author" content="Wilbert Dijkhof">
  <title>Filtre AviSynth ColorYUV</title>


  <link rel="stylesheet" type="text/css" href="../../avisynth.css">

<!-- Automatically generated, don't change: $Id: coloryuv.htm,v 1.3 2005/11/01 09:40:17 macpaille Exp $ -->
</head>


<body>

<h2>
<a name="ColorYUV"></a>ColorYUV
</h2>

<p><code>ColorYUV </code>(<var>clip, float
"gain_y", float "off_y", float "gamma_y",
float "cont_y", float "gain_u", float "off_u", float "gamma_u", float
"cont_u",<br>

&nbsp;&nbsp;&nbsp;float "gain_v", float "off_v", float
"gamma_v", float "cont_v", string
"levels", string "opt",<br>

&nbsp;&nbsp;&nbsp;boolean "showyuv", boolean "analyze",
boolean "autowhite",
boolean "autogain"</var>)
</p>

<p><code>ColorYUV</code> permet de changer la couleur
et la luminance de vos images de beaucoup de mani&egrave;res
diff&eacute;rentes. <code>ColorYUV</code> est
pr&eacute;sent dans AviSynth
v2.5.Tout les arguments de ce filtre sont optionnels. Toutes les
valeurs
sont par d&eacute;faut &agrave; "0".
</p>

<p><var>Gain</var>, <var>off(set)</var>,
<var>gamma</var> et <var>cont(rast)</var>
peuvent &ecirc;tre
param&eacute;tr&eacute;s diff&eacute;remment pour
chaque canal.
</p>

<p><var>Gain</var> sert &agrave; multiplier une
valeur.
Cela veut dire que si le gain est d&eacute;fini
&agrave;&nbsp;0, le filtre pr&eacute;serve les valeurs
telles qu'elles sont. Quand le gain est fix&eacute; &agrave;
256, toutes les valeurs sont multipli&eacute;es par 2 (deux fois
plus de lumi&egrave;re). Si le gain est fix&eacute;
&agrave;&nbsp;512, toutes les valeurs sont
multipli&eacute;es par 3.
</p>

<p><var>Off</var> (offset -&gt;
d&eacute;calage en fran&ccedil;ais) ajoute une
valeur &agrave; la luminance ou &agrave; la chrominance. Un
d&eacute;calage de 16 ajoutera 16 aux valeurs de chaque pixel. Un
d&eacute;calage de -32 enl&egrave;vera 32 aux valeurs de chaque
pixels.
</p>

<p><var>Gamma</var> ajuste le gamma du canal
sp&eacute;cifi&eacute;. Une valeur de 0 correspond &agrave;
une valeur de gamma de 1.0. Quand gamma est fix&eacute;
&agrave; 256, cela correspond &agrave;&nbsp;gamma 2.0.
Gamma
reste valide jusqu'&agrave; -256, cela correspond &agrave;
gamma 0.0.
</p>

<p><var>Cont</var> ajuste le contraste du canal
sp&eacute;cifi&eacute;. L'utilisation est la m&ecirc;me que
celle du param&egrave;tre gamma.
</p>

<p><var>Levels</var> peut &ecirc;tre
fix&eacute; &agrave;
"TV-&gt;PC" ou &agrave; "PC-&gt;TV". Cela effectue une
conversion de plage. Normalement, les valeurs YUV ne sont pas
construites en utilisant des valeurs allant de 0 &agrave; 255
(plage d'un PC) mais une plage plus limit&eacute; (la plage TV,
16-235).
Cet argument effectue une conversion entre ces deux formats. Si rien
n'est sp&eacute;cifi&eacute; en param&egrave;tre, aucune
conversion n'est effectu&eacute;e (op&eacute;ration par
d&eacute;faut).
</p>

<p><var>Opt</var> peut &ecirc;tre soit
fix&eacute; &agrave; "coring" ou &agrave; ""
(rien, param&egrave;tre par d&eacute;faut).
En sp&eacute;cifiant "coring", vous allez
r&eacute;&eacute;chelonner
les valeurs YUV &nbsp;pour obtenir une video dans la plage TV.
Sinon
"invalid results" (r&eacute;sultats non valides) seront
accept&eacute;s.
</p>

<p><var>ShowYUV</var> peut &ecirc;tre true (vrai)
ou false (faux). Cela remplace l'image initiale par une image montrant
les valeurs de chrominance sur les deux axes. Cela peut &ecirc;tre
utile si vous souhaitez ajuster la couleur de votre image, mais vous
devez comprendre comment les couleurs sont construites. En haut
&agrave; gauche, les valeurs de chrominance sont &agrave; '16'.
A droite de l'image, U est maximum. En bas de l'image, V est maximum.
&nbsp;Au milieu, les deux canaux de chrominance sont &agrave;
la valeur 128 (qui correspond au gris).
</p>

<p><var>Analyze</var>&nbsp;peut &ecirc;tre
true (vrai)
ou false (faux). Cela rajoute les caract&eacute;ristiques de
couleurs
sur l'image. On trouve notamment les valeurs maximales et minimales
pour
chaque canaux. On trouve &eacute;galement une moyenne pour tout les
canaux et des valeurs 'limite maximum" et "limite minimum". Ces valeurs
"limites" sont construites pour filtrer les parties bruit&eacute;es
tr&egrave;s claires ou tr&egrave;s sombres en cr&eacute;ant
un minimum / maximum haut ou bas.
</p>

<p><var>Autowhite</var>&nbsp;peut &ecirc;tre
true (vrai)
ou false (faux). Cet argument utilise les valeurs de
l'argument&nbsp;<var>Analyze</var>, et essaie
d'&eacute;quilibrer les
d&eacute;calages de couleurs. Si vous avez une source de type
capture TV ou VHS et qu'une couleur &agrave; bav&eacute; sur
une autre lors de la capture, ce filtre peut &ecirc;tre utile. Mais
soyez prudent car il n'est pas tr&egrave;s intelligent. Si votre
source contient un ciel bleu clair, autowhite le transformera en gris!
Si
vous pr&eacute;cisez les param&egrave;tres "off_u" ou "off_v",
ils ne seront pas utilis&eacute;s.
</p>

<p><var>Autogain</var>&nbsp;peut &ecirc;tre
true (vrai)
ou false (faux). Cet argument utilise les informations du filtre <var>Analyze</var>,
et essaie de cr&eacute;er un contraste aussi bon que possible. Cela
veut dire qu'il modifie les valeurs de luminance (y) pour qu'elles
s'&eacute;talent sur une plage de valeurs maximum. Il agit en fait
de
la m&ecirc;me mani&egrave;re que la fonction "autogain" des
camescopes, en amplifiant les sc&egrave;nes sombreset en ne
touchant
pas aux sc&egrave;nes avec un bon contraste. On peut quelquefois le
retrouver sous le nom de "autolevels".
</p>

<p>Les valeurs caract&eacute;ristiques que sont la
saturation,
&nbsp;le contraste et la luminosit&eacute; (que l'on retrouve
dans <a href="tweak.htm"><code>Tweak</code></a>
par exemple) sont li&eacute;es aux valeurs de ce filtre par les
&eacute;quations suivantes:
</p>

<p>cont_u = cont_v = - (1 - saturation) * 256
<br>

cont_y = - (1-contraste) * 256
<br>

off_y = luminosit&eacute;
</p>

<p>Une saturation de 0.8 donne par exemple: cont_u = cont_v = -
0.2
* 256
= 51.2.
</p>

<p>&nbsp;
</p>

<pre>#&nbsp; Cela ajuste le gamma de tout les canaux (moins sur y que sur les autres), en augmentant 'y'.<br>colorYUV(gamma_y=128, gamma_u=256, gamma_v=256, off_y=-16)<br><br>#&nbsp; Montre toutes les couleurs. La luminance de l'image 0 est 16, celle de l'image 1 est 17 etc...<br>colorYUV(showyuv=true)<br><br>#&nbsp; Am&eacute;liore la visibilit&eacute; sur des mauvais enregistrements.<br>colorYUV(autogain=true, autowhite=true)</pre>

<p><kbd>$English date: 2005/06/01 18:28:01 $<br>

French translation date: 2005/11/01 JasonFly <a href="mailto:macpaille@users.sourceforge.net">macpaille@users.sourceforge.net</a></kbd>
</p>

<form><input value="Retour" onclick="history.go(-1)" type="button"></form>

</body>
</html>
